home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cato / Xm / XmBulletinBoard.z / XmBulletinBoard
Encoding:
Text File  |  2002-10-03  |  37.1 KB  |  595 lines

  1.  
  2.  
  3.  
  4.      XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd - The BulletinBoard widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////BBBBuuuulllllllleeeettttiiiinnnnBBBB....hhhh>>>>
  13.  
  14.  
  15.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  16.           This page documents version 1.2 of the Motif library.
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.           BulletinBoard is a composite widget that provides simple
  20.           geometry management for children widgets.  It does not force
  21.           positioning on its children, but can be set to reject
  22.           geometry requests that result in overlapping children.
  23.           BulletinBoard is the base widget for most dialog widgets and
  24.           is also used as a general container widget.
  25.  
  26.           Modal and modeless dialogs are implemented as collections of
  27.           widgets that include a DialogShell, a BulletinBoard (or
  28.           subclass) child of the shell, and various dialog components
  29.           (buttons, labels, etc.) that are children of BulletinBoard.
  30.           BulletinBoard defines callbacks useful for dialogs (focus,
  31.           map, unmap), which are available for application use.  If
  32.           its parent is a DialogShell, BulletinBoard passes title and
  33.           input mode (based on dialog style) information to the
  34.           parent, which is responsible for appropriate communication
  35.           with the window manager.
  36.  
  37.           The default value for XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllFFFFooooccccuuuussss is the value of
  38.           XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttBBBBuuuuttttttttoooonnnn.
  39.  
  40.         CCCCllllaaaasssssssseeeessss
  41.           BulletinBoard inherits behavior and resources from CCCCoooorrrreeee,
  42.           CCCCoooommmmppppoooossssiiiitttteeee, CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt, and XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr classes.
  43.  
  44.           The class pointer is xxxxmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrddddWWWWiiiiddddggggeeeettttCCCCllllaaaassssssss.
  45.  
  46.           The class name is XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd.
  47.  
  48.         NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  49.           The following table defines a set of widget resources used
  50.           by the programmer to specify data.  The programmer can also
  51.           set the resource values for the inherited classes to set
  52.           attributes for this widget.  To reference a resource by name
  53.           or by class in a .Xdefaults file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
  54.           prefix and use the remaining letters.  To specify one of the
  55.           defined values for a resource in a .Xdefaults file, remove
  56.           the XXXXmmmm prefix and use the remaining letters (in either
  57.           lowercase or uppercase, but include any underscores between
  58.           words).  The codes in the access column indicate if the
  59.           given resource can be set at creation time (C), set by using
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
  75.           not applicable (N/A).
  76.  
  77.                                XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  78.      NNNNaaaammmmeeee                  CCCCllllaaaassssssss                TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt        AAAAcccccccceeeessssssss
  79.      _________________________________________________________________________________
  80.      XmNallowOverlap       XmCAllowOverlap      Boolean          True           CSG
  81.      XmNautoUnmanage       XmCAutoUnmanage      Boolean          True           CG
  82.      XmNbuttonFontList     XmCButtonFontList    XmFontList       dynamic        CSG
  83.      XmNcancelButton       XmCWidget            Widget           NULL           SG
  84.      XmNdefaultButton      XmCWidget            Widget           NULL           SG
  85.      XmNdefaultPosition    XmCDefaultPosition   Boolean          True           CSG
  86.      XmNdialogStyle        XmCDialogStyle       unsigned char    dynamic        CSG
  87.      XmNdialogTitle        XmCDialogTitle       XmString         NULL           CSG
  88.      XmNfocusCallback      XmCCallback          XtCallbackList   NULL           C
  89.      XmNlabelFontList      XmCLabelFontList     XmFontList       dynamic        CSG
  90.      XmNmapCallback        XmCCallback          XtCallbackList   NULL           C
  91.      XmNmarginHeight       XmCMarginHeight      Dimension        10             CSG
  92.      XmNmarginWidth        XmCMarginWidth       Dimension        10             CSG
  93.      XmNnoResize           XmCNoResize          Boolean          False          CSG
  94.      XmNresizePolicy       XmCResizePolicy      unsigned char    XmRESIZE_ANY   CSG
  95.      XmNshadowType         XmCShadowType        unsigned char    XmSHADOW_OUT   CSG
  96.      XmNtextFontList       XmCTextFontList      XmFontList       dynamic        CSG
  97.      XmNtextTranslations   XmCTranslations      XtTranslations   NULL           C
  98.      XmNunmapCallback      XmCCallback          XtCallbackList   NULL           C
  99.  
  100.  
  101.           XXXXmmmmNNNNaaaalllllllloooowwwwOOOOvvvveeeerrrrllllaaaapppp
  102.                     Controls the policy for overlapping children
  103.                     widgets.  If True, BulletinBoard allows geometry
  104.                     requests that result in overlapping children.
  105.  
  106.           XXXXmmmmNNNNaaaauuuuttttooooUUUUnnnnmmmmaaaannnnaaaaggggeeee
  107.                     Controls whether or not BulletinBoard is
  108.                     automatically unmanaged after a button is
  109.                     activated.  If this resource is True on
  110.                     initialization and if the BulletinBoard's parent
  111.                     is a DialogShell, BulletinBoard adds a callback to
  112.                     button children (PushButtons, PushButtonGadgets,
  113.                     and DrawnButtons) that unmanages the BulletinBoard
  114.                     when a button is activated.  If this resource is
  115.                     False on initialization or if the BulletinBoard's
  116.                     parent is not a DialogShell, the BulletinBoard is
  117.                     not automatically unmanaged.  For BulletinBoard
  118.                     subclasses with Apply or Help buttons, activating
  119.                     those buttons does not automatically unmanage the
  120.                     BulletinBoard.
  121.  
  122.           XXXXmmmmNNNNbbbbuuuuttttttttoooonnnnFFFFoooonnnnttttLLLLiiiisssstttt
  123.                     Specifies the font list used for BulletinBoard's
  124.                     button descendants.  If this value is NULL at
  125.                     initialization, the font list is initialized by
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX))))
  137.  
  138.  
  139.  
  140.                     looking up the parent hierarchy of the widget for
  141.                     an ancestor that is a subclass of the
  142.                     XmBulletinBoard, VendorShell, or XmMenuShell
  143.                     widget class.  If such an ancestor is found, the
  144.                     font list is initialized to the XXXXmmmmNNNNbbbbuuuuttttttttoooonnnnFFFFoooonnnnttttLLLLiiiisssstttt
  145.                     of the ancestor widget.  If no such ancestor is
  146.                     found, the default is implementation dependent.
  147.                     Refer to XXXXmmmmFFFFoooonnnnttttLLLLiiiisssstttt((((3333XXXX)))) for more information on
  148.                     the creation and structure of a font list.
  149.  
  150.           XXXXmmmmNNNNccccaaaannnncccceeeellllBBBBuuuuttttttttoooonnnn
  151.                     Specifies the widget ID of the CCCCaaaannnncccceeeellll button.
  152.                     BulletinBoard's subclasses, which define a CCCCaaaannnncccceeeellll
  153.                     button, set this resource.  BulletinBoard does not
  154.                     directly provide any behavior for that button.
  155.  
  156.           XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttBBBBuuuuttttttttoooonnnn
  157.                     Specifies the widget ID of the default button.
  158.                     Some BulletinBoard subclasses, which define a
  159.                     default button, set this resource.  BulletinBoard
  160.                     defines translations and installs accelerators
  161.                     that activate that button when KKKKAAAAccccttttiiiivvvvaaaatttteeee is
  162.                     pressed and the keyboard focus is not in another
  163.                     button.
  164.  
  165.           XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttPPPPoooossssiiiittttiiiioooonnnn
  166.                     Controls whether or not the BulletinBoard is
  167.                     automatically positioned by its parent.  If True,
  168.                     and the parent of the BulletinBoard is a
  169.                     DialogShell, the BulletinBoard is centered within
  170.                     or around the parent of the DialogShell when the
  171.                     BulletinBoard is mapped and managed.  If False,
  172.                     the BulletinBoard is not automatically positioned.
  173.  
  174.           XXXXmmmmNNNNddddiiiiaaaallllooooggggSSSSttttyyyylllleeee
  175.                     Indicates the dialog style associated with the
  176.                     BulletinBoard.  If the parent of the BulletinBoard
  177.                     is a DialogShell, the parent's XXXXmmmmNNNNmmmmwwwwmmmmIIIInnnnppppuuuuttttMMMMooooddddeeee is
  178.                     set according to the value of this resource.  This
  179.                     resource can be set only if the BulletinBoard is
  180.                     unmanaged.  Possible values for this resource
  181.                     include the following:
  182.  
  183.  
  184.                       +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____SSSSYYYYSSSSTTTTEEEEMMMM____MMMMOOOODDDDAAAALLLL-used for dialogs that
  185.                          must be responded to before any other
  186.                          interaction in any application
  187.  
  188.                       +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____PPPPRRRRIIIIMMMMAAAARRRRYYYY____AAAAPPPPPPPPLLLLIIIICCCCAAAATTTTIIIIOOOONNNN____MMMMOOOODDDDAAAALLLL-used for
  189.                          dialogs that must be responded to before some
  190.                          other interactions in ancestors of the widget
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX))))
  203.  
  204.  
  205.  
  206.                       +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____AAAAPPPPPPPPLLLLIIIICCCCAAAATTTTIIIIOOOONNNN____MMMMOOOODDDDAAAALLLL-used for dialogs
  207.                          that must be responded to before some other
  208.                          interactions in ancestors of the widget.
  209.                          This value is the same as
  210.                          XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____PPPPRRRRIIIIMMMMAAAARRRRYYYY____AAAAPPPPPPPPLLLLIIIICCCCAAAATTTTIIIIOOOONNNN____MMMMOOOODDDDAAAALLLL, and
  211.                          remains for compatibility.
  212.  
  213.                       +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____FFFFUUUULLLLLLLL____AAAAPPPPPPPPLLLLIIIICCCCAAAATTTTIIIIOOOONNNN____MMMMOOOODDDDAAAALLLL-used for
  214.                          dialogs that must be responded to before some
  215.                          other interactions in the same application
  216.  
  217.                       +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____MMMMOOOODDDDEEEELLLLEEEESSSSSSSS-used for dialogs that do
  218.                          not interrupt interaction of any application.
  219.                          This is the default when the parent of the
  220.                          BulletinBoard is a DialogShell.
  221.  
  222.                       +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____WWWWOOOORRRRKKKK____AAAARRRREEEEAAAA-used for BulletinBoard
  223.                          widgets whose parents are not DialogShells.
  224.                          XXXXmmmmNNNNddddiiiiaaaallllooooggggSSSSttttyyyylllleeee is forced to have this value
  225.                          when the parent of the BulletinBoard is not a
  226.                          DialogShell.
  227.  
  228.  
  229.           XXXXmmmmNNNNddddiiiiaaaallllooooggggTTTTiiiittttlllleeee
  230.                     Specifies the dialog title.  If this resource is
  231.                     not NULL, and the parent of the BulletinBoard is a
  232.                     subclass of WMShell, BulletinBoard sets the
  233.                     XXXXmmmmNNNNttttiiiittttlllleeee and XXXXmmmmNNNNttttiiiittttlllleeeeEEEEnnnnccccooooddddiiiinnnngggg of its parent.  If
  234.                     the only character set in XXXXmmmmNNNNddddiiiiaaaallllooooggggTTTTiiiittttlllleeee is
  235.                     ISO8859-1, XXXXmmmmNNNNttttiiiittttlllleeee is set to the string of the
  236.                     title, and XXXXmmmmNNNNttttiiiittttlllleeeeEEEEnnnnccccooooddddiiiinnnngggg is set to SSSSTTTTRRRRIIIINNNNGGGG.  If
  237.                     XXXXmmmmNNNNddddiiiiaaaallllooooggggTTTTiiiittttlllleeee contains character sets other than
  238.                     ISO8859-1, XXXXmmmmNNNNttttiiiittttlllleeee is set to the string of the
  239.                     title converted to a compound text string, and
  240.                     XXXXmmmmNNNNttttiiiittttlllleeeeEEEEnnnnccccooooddddiiiinnnngggg is set to CCCCOOOOMMMMPPPPOOOOUUUUNNNNDDDD____TTTTEEEEXXXXTTTT.
  241.  
  242.           XXXXmmmmNNNNffffooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk
  243.                     Specifies the list of callbacks that is called
  244.                     when the BulletinBoard widget or one of its
  245.                     descendants accepts the input focus.  The callback
  246.                     reason is XXXXmmmmCCCCRRRR____FFFFOOOOCCCCUUUUSSSS.
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 4/30/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX))))
  269.  
  270.  
  271.  
  272.           XXXXmmmmNNNNllllaaaabbbbeeeellllFFFFoooonnnnttttLLLLiiiisssstttt
  273.                     Specifies the font list used for BulletinBoard's
  274.                     label descendants (Labels and LabelGadgets).  If
  275.                     this value is NULL at initialization, the font
  276.                     list is initialized by looking up the parent
  277.                     hierarchy of the widget for an ancestor that is a
  278.                     subclass of the XmBulletinBoard, VendorShell, or
  279.                     XmMenuShell widget class.  If such an ancestor is
  280.                     found, the font list is initialized to the
  281.                     XXXXmmmmNNNNllllaaaabbbbeeeellllFFFFoooonnnnttttLLLLiiiisssstttt of the ancestor widget.  If no
  282.                     such ancestor is found, the default is
  283.                     implementation dependent.  Refer to XXXXmmmmFFFFoooonnnnttttLLLLiiiisssstttt((((3333XXXX))))
  284.                     for more information on the creation and structure
  285.                     of a font list.
  286.  
  287.           XXXXmmmmNNNNmmmmaaaappppCCCCaaaallllllllbbbbaaaacccckkkk
  288.                     Specifies the list of callbacks that is called
  289.                     only when the parent of the BulletinBoard is a
  290.                     DialogShell; in which case, this callback list is
  291.                     invoked when the BulletinBoard widget is mapped.
  292.                     The callback reason is XXXXmmmmCCCCRRRR____MMMMAAAAPPPP.  DialogShells are
  293.                     usually mapped when the DialogShell is managed.
  294.  
  295.           XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnHHHHeeeeiiiigggghhhhtttt
  296.                     Specifies the minimum spacing in pixels between
  297.                     the top or bottom edge of BulletinBoard and any
  298.                     child widget.
  299.  
  300.           XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh
  301.                     Specifies the minimum spacing in pixels between
  302.                     the left or right edge of BulletinBoard and any
  303.                     child widget.
  304.  
  305.           XXXXmmmmNNNNnnnnooooRRRReeeessssiiiizzzzeeee
  306.                     Controls whether or not resize controls are
  307.                     included in the window manager frame around the
  308.                     BulletinBoard's parent.  If set to True, the mmmmwwwwmmmm
  309.                     does not include resize controls in the window
  310.                     manager frame containing the parent of the
  311.                     BulletinBoard if the parent is a subclass of
  312.                     VendorShell.  If set to False, the window manager
  313.                     frame does include resize controls.  Other
  314.                     controls provided by mmmmwwwwmmmm can be included or
  315.                     excluded through the mmmmwwwwmmmm resources provided by
  316.                     VendorShell.
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 4/30/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX))))
  335.  
  336.  
  337.  
  338.           XXXXmmmmNNNNrrrreeeessssiiiizzzzeeeePPPPoooolllliiiiccccyyyy
  339.                     Controls the policy for resizing BulletinBoard
  340.                     widgets.  Possible values include the following:
  341.  
  342.  
  343.                       +o  XXXXmmmmRRRREEEESSSSIIIIZZZZEEEE____NNNNOOOONNNNEEEE-fixed size
  344.  
  345.                       +o  XXXXmmmmRRRREEEESSSSIIIIZZZZEEEE____AAAANNNNYYYY-shrink or grow as needed
  346.  
  347.                       +o  XXXXmmmmRRRREEEESSSSIIIIZZZZEEEE____GGGGRRRROOOOWWWW-grow only
  348.  
  349.  
  350.           XXXXmmmmNNNNsssshhhhaaaaddddoooowwwwTTTTyyyyppppeeee
  351.                     Describes the shadow drawing style for
  352.                     BulletinBoard.  This resource can have the
  353.                     following values:
  354.  
  355.  
  356.                       +o  XXXXmmmmSSSSHHHHAAAADDDDOOOOWWWW____IIIINNNN-draws the BulletinBoard shadow so
  357.                          that it appears inset.  This means that the
  358.                          bottom shadow visuals and top shadow visuals
  359.                          are reversed.
  360.  
  361.                       +o  XXXXmmmmSSSSHHHHAAAADDDDOOOOWWWW____OOOOUUUUTTTT-draws the BulletinBoard shadow
  362.                          so that it appears outset
  363.  
  364.                       +o  XXXXmmmmSSSSHHHHAAAADDDDOOOOWWWW____EEEETTTTCCCCHHHHEEEEDDDD____IIIINNNN-draws the BulletinBoard
  365.                          shadow using a double line giving the effect
  366.                          of a line etched into the window, similar to
  367.                          the Separator widget
  368.  
  369.                       +o  XXXXmmmmSSSSHHHHAAAADDDDOOOOWWWW____EEEETTTTCCCCHHHHEEEEDDDD____OOOOUUUUTTTT-draws the BulletinBoard
  370.                          shadow using a double line giving the effect
  371.                          of a line coming out of the window, similar
  372.                          to the Separator widget
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 4/30/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX))))
  401.  
  402.  
  403.  
  404.           XXXXmmmmNNNNtttteeeexxxxttttFFFFoooonnnnttttLLLLiiiisssstttt
  405.                     Specifies the font list used for BulletinBoard's
  406.                     Text and List descendants.  If this value is NULL
  407.                     at initialization, the font list is initialized by
  408.                     looking up the parent hierarchy of the widget for
  409.                     an ancestor that is a subclass of the
  410.                     XmBulletinBoard or VendorShell widget class.  If
  411.                     such an ancestor is found, the font list is
  412.                     initialized to the XXXXmmmmNNNNtttteeeexxxxttttFFFFoooonnnnttttLLLLiiiisssstttt of the ancestor
  413.                     widget.  If no such ancestor is found, the default
  414.                     is implementation  dependent.  Refer to
  415.                     XXXXmmmmFFFFoooonnnnttttLLLLiiiisssstttt((((3333XXXX)))) for more information on the
  416.                     creation and structure of a font list.
  417.  
  418.           XXXXmmmmNNNNtttteeeexxxxttttTTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  419.                     Adds translations to any Text widget or Text
  420.                     widget subclass that is added as a child of
  421.                     BulletinBoard.
  422.  
  423.           XXXXmmmmNNNNuuuunnnnmmmmaaaappppCCCCaaaallllllllbbbbaaaacccckkkk
  424.                     Specifies the list of callbacks that is called
  425.                     only when the parent of the BulletinBoard is a
  426.                     DialogShell.  In that case, this callback list is
  427.                     invoked when the BulletinBoard widget is unmapped.
  428.                     The callback reason is XXXXmmmmCCCCRRRR____UUUUNNNNMMMMAAAAPPPP.  DialogShells
  429.                     are usually unmapped when the DialogShell is
  430.                     unmanaged.
  431.  
  432.  
  433.         IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  434.           BulletinBoard inherits behavior and resources from the
  435.           following superclasses.  For a complete description of each
  436.           resource, refer to the man page for that superclass.
  437.  
  438.                                           XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  439.      NNNNaaaammmmeeee                    CCCCllllaaaassssssss                   TTTTyyyyppppeeee                DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  440.      _________________________________________________________________________________________________
  441.      XmNbottomShadowColor    XmCBottomShadowColor    Pixel               dynamic                CSG
  442.      XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
  443.      XmNforeground           XmCForeground           Pixel               dynamic                CSG
  444.      XmNhelpCallback         XmCCallback             XtCallbackList      NULL                   C
  445.      XmNhighlightColor       XmCHighlightColor       Pixel               dynamic                CSG
  446.      XmNhighlightPixmap      XmCHighlightPixmap      Pixmap              dynamic                CSG
  447.      XmNinitialFocus         XmCInitialFocus         Widget              dynamic                CSG
  448.      XmNnavigationType       XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
  449.      XmNshadowThickness      XmCShadowThickness      Dimension           dynamic                CSG
  450.      XmNstringDirection      XmCStringDirection      XmStringDirection   dynamic                CG
  451.      XmNtopShadowColor       XmCTopShadowColor       Pixel               dynamic                CSG
  452.      XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap              dynamic                CSG
  453.      XmNtraversalOn          XmCTraversalOn          Boolean             True                   CSG
  454.  
  455.  
  456.  
  457.  
  458.  
  459.      Page 7                                          (printed 4/30/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX))))
  467.  
  468.  
  469.  
  470.      XmNunitType             XmCUnitType             unsigned char       dynamic                CSG
  471.      XmNuserData             XmCUserData             XtPointer           NULL                   CSG
  472.  
  473.                              CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  474.      NNNNaaaammmmeeee                CCCCllllaaaassssssss               TTTTyyyyppppeeee          DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  475.      ______________________________________________________________________
  476.      XmNchildren         XmCReadOnly         WidgetList    NULL      G
  477.      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
  478.      XmNnumChildren      XmCReadOnly         Cardinal      0         G
  479.  
  480.                                                    CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  481.      NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  482.      ______________________________________________________________________________________________________________
  483.      XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                N/A
  484.      XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
  485.      XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
  486.      XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  487.      XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
  488.      XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  489.      XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
  490.      XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
  491.      XmNdepth                        XmCDepth                        int              dynamic                CG
  492.      XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
  493.      XmNheight                       XmCHeight                       Dimension        dynamic                CSG
  494.      XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
  495.      XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
  496.      XmNscreen                       XmCScreen                       Screen *         dynamic                CG
  497.      XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
  498.      XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
  499.      XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
  500.      XmNx                            XmCPosition                     Position         0                      CSG
  501.      XmNy                            XmCPosition                     Position         0                      CSG
  502.  
  503.         CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  504.           A pointer to the following structure is passed to each
  505.           callback:
  506.  
  507.           ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt
  508.           {{{{
  509.             iiiinnnntttt      _r_e_a_s_o_n;;;;
  510.             XXXXEEEEvvvveeeennnntttt   * _e_v_e_n_t;;;;
  511.           }}}} XXXXmmmmAAAAnnnnyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt;;;;
  512.  
  513.  
  514.           _r_e_a_s_o_n Indicates why the callback was invoked.
  515.  
  516.           _e_v_e_n_t  Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback.
  517.  
  518.  
  519.         TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  520.           XmBulletinBoard includes the translations from XmManager.
  521.  
  522.  
  523.  
  524.  
  525.      Page 8                                          (printed 4/30/98)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX))))
  533.  
  534.  
  535.  
  536.         AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr
  537.           The XmBulletinBoard widget has the additional behavior
  538.           described below:
  539.  
  540.  
  541.           MMMMAAAAnnnnyyyy KKKKCCCCaaaannnncccceeeellll:
  542.                     Calls the activate callbacks for the cancel button
  543.                     if it is sensitive.  If no cancel button exists
  544.                     and if the parent of the BulletinBoard is a
  545.                     manager, passes the event to the parent.
  546.  
  547.           KKKKAAAAccccttttiiiivvvvaaaatttteeee:
  548.                     Calls the activate callbacks for the button with
  549.                     the keyboard focus.  If no button has the keyboard
  550.                     focus, calls the activate callbacks for the
  551.                     default button if it is sensitive.  In a List
  552.                     widget or single-line Text widget, the List or
  553.                     Text action associated with KKKKAAAAccccttttiiiivvvvaaaatttteeee is called
  554.                     before the BulletinBoard actions associated with
  555.                     KKKKAAAAccccttttiiiivvvvaaaatttteeee.  In a multi-line Text widget, any
  556.                     KKKKAAAAccccttttiiiivvvvaaaatttteeee event except KKKKEEEEnnnntttteeeerrrr calls the Text
  557.                     action associated with KKKKAAAAccccttttiiiivvvvaaaatttteeee, then the
  558.                     BulletinBoard actions associated with KKKKAAAAccccttttiiiivvvvaaaatttteeee.
  559.                     If no button has the focus, no default button
  560.                     exists, and the parent of the BulletinBoard is a
  561.                     manager, passes the event to the parent.
  562.  
  563.           <<<<FFFFooooccccuuuussssIIIInnnn>>>>:
  564.                     Calls the callbacks for XXXXmmmmNNNNffffooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk.  When
  565.                     the focus policy is XXXXmmmmPPPPOOOOIIIINNNNTTTTEEEERRRR, this happens when
  566.                     the pointer enters the window.  When the focus
  567.                     policy is XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT, this happens when the user
  568.                     traverses to the widget.
  569.  
  570.           <<<<MMMMaaaapppp>>>>:    Calls the callbacks for XXXXmmmmNNNNmmmmaaaappppCCCCaaaallllllllbbbbaaaacccckkkk.
  571.  
  572.           <<<<UUUUnnnnmmmmaaaapppp>>>>:  Calls the callbacks for XXXXmmmmNNNNuuuunnnnmmmmaaaappppCCCCaaaallllllllbbbbaaaacccckkkk.
  573.  
  574.  
  575.         VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss
  576.           The bindings for virtual keys are vendor specific.  For
  577.           information about bindings for virtual buttons and keys, see
  578.           VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX)))).
  579.  
  580.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  581.           CCCCoooommmmppppoooossssiiiitttteeee((((3333XXXX)))), CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt((((3333XXXX)))), CCCCoooorrrreeee((((3333XXXX)))),
  582.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX)))), XXXXmmmmCCCCrrrreeeeaaaatttteeeeBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrddddDDDDiiiiaaaalllloooogggg((((3333XXXX)))),
  583.           XXXXmmmmDDDDiiiiaaaallllooooggggSSSShhhheeeellllllll((((3333XXXX)))),,,, and XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))....
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.      Page 9                                          (printed 4/30/98)
  592.  
  593.  
  594.  
  595.